package org.jupiter.blog.service.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.jupiter.blog.api.domain.JupiterBlogStat;

import java.util.List;

/**
 * 博客统计信息 Mapper 接口
 * 
 * @author lwl
 * @date 2024-01-15
 */
@Mapper
public interface JupiterBlogStatMapper {
    
    /**
     * 根据博客ID查询统计信息
     * 
     * @param blogUuid 博客ID
     * @return 博客统计信息
     */
    JupiterBlogStat selectByBlogUuid(@Param("blogUuid") String blogUuid);
    
    /**
     * 插入博客统计信息
     * 
     * @param blogStat 博客统计信息
     * @return 影响行数
     */
    int insert(JupiterBlogStat blogStat);
    
    /**
     * 更新博客统计信息
     * 
     * @param blogStat 博客统计信息
     * @return 影响行数
     */
    int update(JupiterBlogStat blogStat);
    
    /**
     * 根据博客ID删除统计信息
     * 
     * @param blogUuid 博客ID
     * @return 影响行数
     */
    int deleteByBlogUuid(@Param("blogUuid") String blogUuid);
    
    /**
     * 增加阅读量
     * 
     * @param blogUuid 博客ID
     * @param increment 增量
     * @return 影响行数
     */
    int incrementViewCount(@Param("blogUuid") String blogUuid, @Param("increment") Long increment);
    
    /**
     * 增加点赞量
     * 
     * @param blogUuid 博客ID
     * @param increment 增量
     * @return 影响行数
     */
    int incrementLikeCount(@Param("blogUuid") String blogUuid, @Param("increment") Long increment);
    
    /**
     * 增加收藏量
     * 
     * @param blogUuid 博客ID
     * @param increment 增量
     * @return 影响行数
     */
    int incrementFavoriteCount(@Param("blogUuid") String blogUuid, @Param("increment") Long increment);
    
    /**
     * 查询热门博客（按阅读量排序）
     * 
     * @param limit 限制数量
     * @return 热门博客统计信息列表
     */
    List<JupiterBlogStat> selectPopularBlogs(@Param("limit") Integer limit);
    
    /**
     * 查询所有博客统计信息
     * 
     * @return 博客统计信息列表
     */
    List<JupiterBlogStat> selectAll();
    
    /**
     * 批量插入博客统计信息
     * 
     * @param blogStats 博客统计信息列表
     * @return 影响行数
     */
    int batchInsert(@Param("blogStats") List<JupiterBlogStat> blogStats);
}
